' ./ 
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.... .. r f 


h 
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h IJ-&Q - ^ • H oose 

_ Ma. ci&r< r •« uS.ri2i‘ 
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r ^.. 


DISPLAV L. I STS SI liPL IFI ED 


U*/u/y- '■ sMm fra rfJbt- Sozlial' 




A TAR I 


u ndcrsrta±\ <xin a 

An important iwUi&W- step- in you r 

s srai-hi cs capabilities is to create your own custom 


d i sr 1 ay i i s t s „ h i. s a r t i cjjg^ f -Cte jp— by - i' ffy 

" $fiOW 

^ W 1 1 1 •=» O U 


rii ix 


a nd 


r=» r a p h i c s o n y o u r T U 


to modify Graphics liod* 


.reen„ Our method uses BASIC commands 




0 through 8. 

4775 W>~ 


BASIC r ^ sacrifices some of the ^ flexi bilityj 


A 


* *< &■! ■ I - a b "$ p 


=¥=?=»= 




«e r : . 


l&ese i:eck/UQj/eS ^}// /te/p 


ioj/es w 

y o u eve i > t ua 11 y 

'<m c r e a t e d i s r 3. a. y 1 i s1. s i n /4 s e m b 1 y La ri s u a s o, 


T he *=» rap h i cs cap a b i 1 i t i 


by a nocroprocessor 

Obc; 

I n te r fa ce f 3. r c u :i. t > „ tft 


of the ATARI are con 1 r o’ 
a 11 ed ANT IC < A1 r ha ^ N ume r i c T e 3. ex i : : 


Wty 

display 


:» list is a pros ram for ANTIC 






M<: 


* i i 


DISPLAV LIST 


~rfuure (s a. cii'sphy prog rfr”i ‘ 


eajcA^ 


fT^ow i d ed a u t o rn a t i c a I 1 y b y ^ B A SI0 s r a p h i c s o m rn a n cJ ^ 

define you^ou/x,. specifies 

. The display list where screen 

data is located? what display modes to use? and any special 
display options- ANTIC is to implement- Since the display 


you 

or QAioaht 


list describe 


t h e s c r e e n f r o m t o f t o b o 11 o m ^ any m i x o f 

Modes 


graphics or text can be displayed on the 

A 


: r e e n - 


To flfc 2 /Vt>£r/ understand displays you need to know a 

VulA&Jmx b i t a bo u t te 1 ew i s i o n , I n a TU ? a beam o f 


elect rons 


L 




is shot at the screen. The beam starts at 

t h e t o p 1 e f t «*■ h a n d c o r n e r a n d m o w e s a c r o s s t h e 

screen« When .i t reaches t he r i sh t- hand side ; 

ii- turned otf^sHri returned to the left *imowed 

d ow n s 1 i s h 11 y . It i s t he n t u r ned o n as a i n 9 a nd t he f- ro cess \ s 
& to / scnujyy 

r e p e a t e d 262 t i rri e s jf o r m a c o rn p 1 e ted^Tmas e . Jj W h e n t he be a rn 

r eac hes t h e b o 11 o rri r i s hi t — bi a n d c o r n e r o f t he s c ree n ? it i s 

tur ried of f and retur n&of to t bie to p 1 ef t — hand cor rier to start 

Tfese 

owe r. li+vMH?: horizontal sweeps are called scan lines and 

fi 

a re t he bas i s o T t he d i sf :> 1 ay « 1 he s ca n — J. i nc^f^ a c t ua 1 1 y s ta r tS 

a bo we and ends below the physical boundaries of TU 

To assure tAa£ diyUaqeA 

s c reen. ftAt&siU wot :i. n f o r rn a t i o n i s no t w bie r e y n * i ra n ? 1 

t^Jssc/aX’CuJ 

see it? the display'isrestricted to 192 

A A 


can lines 






7 








3)0 (\ioj~~ 



REM PROGRAM 1 
? CHR*<125>=GRAPHICS G 
0 DL-F'EEK < 56© > +PEEK < 56 i > +256 s POKE DL + 16.-1 3© 

B FOR J=0 TO I©:READ B:POKE 1536+J,B:NEXT J 
5 DATA 72, 169, 42, 141? 10? 212? 141, 24,208,1©4* 6 
3 POKE 512, O: POKE 513, 6 
5 POKE 54286,192 
3 GOTO 40 





O ~y~-^ 



1 REM PROGRAM 2 

I O J DL=PEEK < 560 >+PEEK<56 1 > +256 :POKE DL+1*’1 
20 FOR J=0 TO 28: READ B: POKE 15o>to+J, &• NE*T J 

1--2.72, 169,42, 162, 192, lfc-tf,'^, 141, lO,-l. 

30 DATA i;i,S:208, 140,26,208, 104, 168, 104, 170, 104,64 
35 POKE 512,0:POKE 513, 6 

48 POKE 54286,192 

p.-,L-p 7 S 2 , 1 : REM TURN OFF CURSUR 
ti on-TTTrw F 11:6 # 6 :"DISPLAY LIST INTERRUPT" 
pnc ! T l r,H S- 12 : ? 46 ; " y ITH THREE COLOR CHANGE 6 " 

It posJlOH 0»©SPOKE 7S2.0.REM RESTORE CURSOR 


:, 141 , 24,208 





s .tin ••••• I.... o I- e n z S u . 1 . x r L. R y 




D E UE L 0 PIN 6 A C U S T 0 M DIS P L A V LIS T 


STEP 1 




/ \ 

, '> A C 

^ e? ^ 


Make a roush sketch of what you want to appear on th< 

0 un a*- ^fUvu. 1 . 


ATARI 


li PUN 


Fitju-re I - <g' S&bCTy^ ilah'c 


0O 1 ' ^ STEP 2 


Select the Graphics Modes you want to use and the 

/or 

number of lines /// each mode. Two requirements must be met. 

iU 

First? the total number of scan lines in ail mode lines 

A 

should not exceed 192. If it does the ^n?a y /J r oil. 

/ A 

However? the total can be less than 192 with no adverse 

effect. Se co nd w he n y o u i rise r t new mod e 1 i nes i n to a n 

e x istins d i s f- 1 a y 1 i s t ? t he t o t a 1 n u rn l:« e r o f b y t e s r e u i re d 

for the inserted lines must be a whole multiple of the 




bytes required per mode line in the existing display 

F/fUre. 2.. 

list. To understand this more fully? refer to i dio d4 - vtOl ‘ "o .m 

l' W4»-rn-».md' —t±iaJL-z r^^ *2 i as rams s u c h as t hi i s wr- c*AX 

i n o a 1 ua b 1 e i n f- 1 a n n i ri s a d i s f* 3. a y 1 i s 11. 




^<4 

s P1Sfy 

XcrWca l(A 

/*. 0 \ 

lc'-<ZAbe >x 

7 } U \ 

Cm + I 

CLd&r-t j 

a *4 i 

po&k. 

‘ fnto 
pc6^'cn\ 



1 X 20 - 40 


qo* = 5 /*o 


4 x io = Wo 


Graph t<$ mo oe z - 

(2 lines) 


Scunl mes 
2 , x l - 3Z 


gramks Mope 8 - mtftxn 
(lie l ines) 


6K\mcs Moot 1 ' Kewmr 
(M lines) 


l Z8 x 1 - 1 


V 


Fi^ixre 2. t-Wit 


q * 8 -32 

rorAL I9Z 


w i 1 1 


mod i f y an 


^r~ cr rjr^c-te 6 u r eX a m ** 1 e 

G rap hi i cs 8 d i sp 1 ay 1 i s t. Ea c h 1 :i ne o f G rap h i cs 8 re=» u i res 

°f 

0 b y t e s- R A M - 1 1 


40 


*herefore:• at 1:he to f- w e rnust i nsert at least 


t ‘.-.i o line s o f M o d e 

a/ Mods <? 

fcri- n»zrM-4ij f ad. =fa 

of Mode 1r 


( Zto<» JasLjlv x -20 iujtcsJ. 6 t&A *40 

ui!t3? »4 > i -rndrT4 ^ i ■ > 1 i ui~ro 1 - ii * 4 - bu -■ f-c r » 

ja/r 

sert''I lines 


At the bottom we will in 


ea c h rea u i r i ns tit by tes^ fo r a to ta 1 o f 40 by tes. 






Ma t c h i ns* up t he 
1 i nes a nd ex i s t i ns 3. i ne: 

j“i^i>rr % I'l i 11 i "‘ T ~ r\ t ~ r "' t ex t a r*i < 

t hem. 


b y t 0 r e ;:: i u i r e rn e n t s b e 

tween i rise 

r ted 

i n s- u res t hi a t 

the JgcS= 

•St-nd~ HRW' ^'*^ =z 

=■«=*' 

e ran hi i cs w i 11 

a p' P' e a r 

i.o h e r e w e 

wa n t 


’pf£^ 

■ 


STEP 3 


Ayvnh) sAtwr/C t 

_ 

J-y- r \r~ . . ’tkym, 

y£>e te rm i ne from fable X which of istes 




res ulr 


tooft RAM. tkis mode as your hose, (ensttno) mode. 

the a so* ■+*■ ■ 1 1 * ■ nr ro:: . n n t o f RAM. V > l « m^ =* teJLL^Ta ch *-fry ' 

o*c£o wHich you make ~thcd 

nr ^ ri -" 1 i t 4^-— c rea 3:e y o u r c us torn 

n~hie 

display list. t Iiv,r w ■■■ ‘pj-wnm--fi'AM -mi-ato insures that the 


OS has set asid* 
data. 


: i e n t rnerno ry to ho 1 d y o u r s creeri 

MooU $ ru^tMAjyp yjiA- /nurct RAM j m> ut iaaoM j 
< oua y^ui , CaMu£ jUwl 30 } Aud / 



-W-e—!?rr 

*t»—now 

—ready—to—wri to 

--H-d-i. 


tfe 

h i a '■A e 

chosen Modes 2!? 

*~> a nd 

i//irs 

A 

a 1 i ne to c 

: 1 ea r 

3: hi e s c r e e n a ri d 

t u r n 

o f f t hie 



28 ? CHR*<125> 

s POKE 

7152, 1 


jj: 

W- '^ kU f 

OJ^*' te 


Next we call the display list to be roc 

30 GRAPHICS 8+1*: 


y 

rn o d i f i e d (y —> 



5 6 k. %, 

nrt /4-ddins 16 b l> t !: : tus d 


~ tLo± is cl normal p&rt o£ C&. J* 

/window a n ■■ ■) l.. m x,l .M n.gr "■ .a > ~ p i ,llr m ^ 


e 1 i rn i na t n£pm t he Kinyuf. <Sft- (5 

,.i,,iq lr 1 


recoMmedid "tk&£ you Phtef- the. <xj we 

oJcr*^ ■ It ia/)U kelp you. UMxdAiItamjtt the, 







STEP 4 


PEEK the display list pointer and assign it to a variable such 
as, “DL“. 

4 0 D L ::r - P E E K '•! 560 > •+■ P E E K < 5 6 1 > : + : 2564 


0 


The number 4 is added to the display list pointer for 

insurance. 

' i n l irrruji Eh a . Recall that the TU 


9 enera tes 

s ca n 

lines that do not appear on the 

screen, T o 

all ow 

f o r 

this. 

B A SIC (3 r a f- h i c s M od e s iXke 2 4 

blank scan 

1 i nes 

at 

the s 

ta r t o f t he d i sp 1 ay 1 i s t« Ad d i 

ns 4 to the 

di sp 1 ay 

1 i s t 

po i n te r «,.«i 11 ;w*s u re t ha t 

».,.ie d o n ? t 


ind averta n11y remove a ny of t hese 1ines- 


W 

Qc 



Value. 71 cSjAas^ma 


POKE t he LMS i ns t r u c t i. o n i n to DL-1 . 

AflJTtC SWIVEL*- /vU(^n/^} Yj yjfUx(M 

\h i s i ns t r u c V i o n «.*.» i 1 1 es ta b 1 i s h the f i r s t mod e line 

belongs to yoajr Jbase, 

of the display list. If your first mode line 


mode t- he rf ts p l -q ry f si. j era 7 > ~o ~ f >+od4r fy i n ew skip this steps 



50 POKE DL.1,71 


gaitf 

QC. 


STEP 6 


Every mode line in your diagram requires 


s t a t e m e n t i. n y o u r 







d i sf 1 ay 


1 i S- t. 




in the same 

L c^d POKEj 

HtsAybA/faw appea r on t he s c reenf”*e AN 1 I *— Jnod e n urn be r —■ 

AS 

aFF' rop r i a te # 



£••0 POKE. DL. + z‘ ? »■' 


T his i s t he s econd 1 i ne of our G ra f- hi c s N ode 2 


From the diagram we can see that the next 128 lines are Gr a f* hi «... 

(Oyr 6 gse~ j theSQ /in&s 

P, p i n rp + h i s i s^^H^^rTod e a 1 read y ex i s t 

A J 

i n t hi e d i s f* 1 a y 1 i s t» 1“ hi e n e x t m o d e 1 i ne s t o i n s e r t a r e the f o u r 


G rap hies 1 1 i nes « oJy bottom . 


70 POKE DL-KL^*, 6 
80 POKE DL-»- U3>6 
9© POKE DL+lJ4»6 
100 POKE DL+ljSf’6 


STEP 7 


j-ollo]njQ.oL by ihe. 


End the display list with a JOB:- the low byte and hish byte 

A 

o f t he re t u r n ad d ress : 


i|)0 POKE DL.+136, 65 
120 POKE DL+137,PEEK <560 > 
130 POKE DL+138 =- PEEK < 561 > 
140 GOTO 140 


l 

RU>J ~£U /i ^ c 1 

jU* mJJU AldJ^hL*,. 

To «. <-<&& H ^ 30 t " : 

So GWMCS 8 + 1^: SBTCoucK. 2,0,0 






'T'o.ble. 3 sfxot^s Oc/r 

H4^Cp^ the relevant portions of display list 

/> 



*70 n 


***4^>M^ a n «:.1 

Line 30 of our 


program has stored the LMS instruction in Address 32851- Line 
40 stores the walue 7 in Address 32854 to giye us the second 
mode line of Graphics 2- Instructions for the Graphics 1 line 

a n d J U B a r e s t o r e d i n A d d r e s s e 5? 32986 t h r o u s h 32992 7/1 L o o k a t 

„ 

A d d r es s e s 32947 t hi r o u s hi 3 L* 4 9 4 wwvisl fio t e t h a tfTn t h e rn i d d 1 e o f 

list iS CUtfttLfiA' 

t h e d i s p 1 a y mvvww L M 8 i n s t r u c t i. o n f o 1 1 o w e d b y a 

A 

s c r e e n m e rn o r y a d d r e s s l 1" h e r e a s o n i s t hi a t 

ANTI C c a n ri c* t a d d r e s s a b 1 o c k o f m e m o r y 1 o n s e r t hi a n 41< 
by tesi S i n ce G rap h i cs 8 re ~\ u i res 8K by tes ; 


fA<bi£AM^f the screen memory must be broken up into two 

b 1 o c k s. A N TIC i s s e n t t o t hi e f i r s t b 1 o c k o f s c r e e n rn e rn o r y 

b y t hi e firs t L li S i. n s t r u c t i o n i n A d d r e s s 32851 j 

and is sent to the second block of screen 

7 

merno ry by t hie se co rid LM& i ns t ru c t i o n i n Ad d ress 3 l94^» « 

«3g3gp^i r; r i,i —nT%,-n « j. oe h Ye M: . ■ * J ump i ns t he 

4 K bo u n d a ry ? U o c c u r s o ri 1 y f o r G r a p h i c s -eo i tisn 

^ t Wo tkih<js ) 

ofVw hen y ou mod i fy 

A 






you rnust be careful 





Moose 


. r e n z - D I S P L A V L IS T S 1 3 . 


F i. r s td o n ? t c 1 o b b e r t h e s e c o ri d L M S 


:l ns t r u c t i o n a nd t he boo ^ by tes y f c« I 3. qi.-j :i. mg ) 3. by f- u tt i ns -9 

rtwst 

mode lines in their place. Second? you calculate an 

// /o^ chowre, modes the, jb+v*jo bovvcbtiAM 

offset . uzssSerdrr^^ ■rl ^gritauft ■■!Wg3 3sg ^ , ra- , 'fr «■■ t tom — m » ■Hrfr e^u? ^ 

. / 70 f i?V GU&&r^i ~tuH? J^yut^ ~to (H<Asjl<U4 Jfcvk ( 3>l-+/3'2. VS. 

lye d i dTTn line 50? ^f!hrrg "-'-i Ua- -"*--*' u ^-- .fi n 1 « 

^ J)L+130). 


y\We urs(e you tx;< type\in 1in^s 20 to 146, In ttyLs way ) 
v^ou can\ee th^screenN^i sp 1 a^Kand th<^ process will be \ore : 
meata i ns f u 1 /\j 


At this point the 


: t ua I d i sf- 1 ay i s w r i t te n i n t« 


creeri memo ry . T h 




task will be to p rint "ATARI" in 


t he 8rap h ics 2 sec tion. 


? Line 100 





the OS 

e lo toma L itra 1‘ 1 -* i. ns t r uc te d t h a t da ta i n screen memory is 

t o b e i n t e r f- r e t e d a s s r a f- h .i c s ? n o t t e t. C o n s e a u e n 11 y i f w e 

slmp/y a/ o£ 

jFiityPtW# enter PRINT #6" "ATARI"? the OS will carry 

out the command. The OS must be told how to interpret the data 
it finds in screen memory by POKEins the appropriate Graphics Mode 
n um ber i n to memo r y a d d r es s 87« 

148 POKE 87?2 


8?05 PRINT #6? " 


15© POSITION 


AT AR I 




r ci n s ee r r o r rn e s 


the sc 
Be fore 



s 9 ss and troubIe po 3 i tioni. ris rnaterial on 

for 

cure hoth f- rob 1 erns is fai rIy sirnF-le. 

d i sf 3. a y o n t h e s c r e e n , c h a n s e 


the start of screen memory to coincide with the 

toocU. 


start of 

t h e s e c 

A 

:tion where 

you want 

the . 

display to appear. 

F o r t hi e 

Grap hi 

cs Mode 8 

se ction 

t h i s 

w ill e 1 i rn i na te t he 

t rial—and 

-er ror 

me t hod of 

f- 1 a cerne n t. 

Fo r 

t he G rap hics Mod e 

1 section 

t h i s w 

till prevent 

// 

a cursor 

o u t < 

4 = J/ 

c* t r a n s e rn e s s a s e „ 


To write our display we start with- 

166 POKE 87,6* 


to tell the uy what rnc'de ws ? re in« 1 hen locate the current top 
of the screen address with! 

178 TPSCRN-PEEK<88>+PEEK<89>*256 


i 





ii 


o r 


f n r,. : r.: 


D I 


L I ST 


N e x t o f f s e t t hi €•; o a r i a. b 1 e T P S C R N b y t hi e n u m b e r o f b y t e s i n t hi e 

(-fou/’ * s 40 byhzs) ; 

Mod 0 ju! 1 i nss + l^TpjMod*** !«:.! 1 i nesyf\.W& by tes pst I i 


/ 


7 


188 TP3CRN=TPSCRN+41 


Finally? POKE this memory location back into 88 (low byteT 
and 89 <hish by te) : 


190 POKE 88 ?TPSCRN—< INT <TPSCRN/256>*256> 


2O0 POKE 89? INT <TPSCRN-*'256> 


This procedure sets^up the Graphics 8 section of our display 
so that the top left hand corner corresponds to position 0?3. 


V o u c a n a p f* r e c i a t e hi o w m u c h s i m f- 1 e r i t w i 1 1 b e t o f- 1 a c e y o u r 
d isplay corriponents. 


210 COLOR 1sFOR 1=1 TO 40 STEP 5 


220 PLOT 68+1 * 40+1 s DR A WTO 180 +1 ? 48+1: DR ANT 0 180+1 ? 80+1: 
D R A W T0 60+1 ? 8 8 +1 = D R A W T0 60+1 ? 4 0 +1 


238 NEXT I 




Mo 


DISPLAY LISTS 14 


Finally, print "IS FUN" in the Mode 1 section at the bottom 
o f the screeri. 

240 POKE 87? 1. 

258 T P S C R N « T P S C R N+5121 

Line 258 offsets TF'SCRN to the beginning of the Mode 1 secti 
5121 is obtained from <128 lines of 8r. 8> * <40 bytes per 1 
— 512 0 b y t e s *+■ 1 « 


260 POKE 88 . TF'SCRN- < I NT < TPSCRN--256 > *256 


270 POKE 89. I NT < TF'SCRN-"'256 > 


288 P 0 SI T10N 6.2: ? #65 "1S FUN 1 ' 


290 G 01"0 290 


o n - 
i ne > 




